home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 21 / Cream of the Crop 21 (Terry Blount) (October 1996).iso / os2 / nftp082.zip / nftp-man.txt < prev    next >
Text File  |  1996-08-15  |  39KB  |  945 lines
  1. DRAFT. EXPECT SOME OMISSIONS AND INACCURACIES
  2. ----------------------------------------------------------------------------
  3.  
  4. NFTP : New File Transfer Protocol Client Version 0.82
  5. Copyright (C) 1994-1996 Sergey Ayukov
  6.  
  7. ----------------------------------------------------------------------------
  8. Home page of NFTP is http://crydee.sai.msu.su/nftp/
  9. Check it for new versions, updates etc.
  10.  
  11. Contents
  12.  
  13.   1. Introduction
  14.   2. Installation
  15.   3. Quick start
  16.   4. Usage
  17.         o Launching NFTP
  18.         o Logging in and out
  19.         o Behind the firewall
  20.         o Navigating remote site and local directories
  21.         o Transferring files
  22.         o Customizing NFTP
  23.   5. Keyboard commands summary
  24.         o General keyboard commands
  25.         o Control connection window
  26.         o File listing (remote and local)
  27.         o Entry fields
  28.         o Bookmark list
  29.         o Built-in file viewer
  30.   6. Known bugs and limitations
  31.   7. Troubleshooting
  32.   8. Licensing information
  33.   9. Acknowledgements
  34.  10. Registration
  35.  11. Contacting the author
  36.  12. Version history
  37.  
  38. ----------------------------------------------------------------------------
  39.  
  40. INTRODUCTION
  41.  
  42. NFTP is a text-mode ftp client for OS/2. Comparing to popular ncftp, it has
  43. a number of enhancements:
  44.  
  45.    * remote directory view is fully scrollable with minimum keystrokes
  46.      required;
  47.    * remote directory contents is cached during one session - you'll never
  48.      have to wait for retrieving the same listing;
  49.    * marking files for download/upload: you don't need to type filenames at
  50.      all;
  51.    * remote file viewing is more simple and intelligent, and viewed files
  52.      are cached as well;
  53.    * you can see client-server negotiation (even complete history during all
  54.      run);
  55.    * NFTP has batch progress indicator (you see how long will take entire
  56.      operation if more than one file was selected to transfer);
  57.    * file selection is simple and allows to view remote files while marking
  58.      others to transfer;
  59.    * you can skip files during transfer while continuing to download/upload
  60.      the rest;
  61.    * you can mark files in different directories and then retrieve them all;
  62.    * you can sort remote directories by name, size, date/time.
  63.    * NFTP comes in 12 languages: Brazilian Portuguese, Chinese, Danish,
  64.      Dutch, English, German, Hungarian, Italian, Japanese, Norwegian,
  65.      Russian, Spanish, Swedish.
  66.  
  67. The biggest advantages over majority of PM ftp clients (like FTP-PM, sftp
  68. etc.) are the ability to 'reget' (continue transfer after interruption),
  69. speed of simple and effective text-mode interface, small memory
  70. requirements.
  71.  
  72. In my opinion, LW-FTP while being very elegant is useless due to big
  73. overhead of Workplace Shell object creation/deletion.
  74.  
  75. OS/2 4.0 (Merlin) has introduced concept of 'FTP Folder', similar to LW-FTP
  76. and offering seamless integration of FTP client and Workplace Shell (via WPS
  77. class). They are funny and easy to use, but play and work are different
  78. things. If you really need to transfer files regularly and in large
  79. quantities you'll look for more useful and less fancy program than 'FTP
  80. Folder'.
  81.  
  82. However, NFTP isn't free as ncftp. But registration fee is only US$ 20 --
  83. and you'll get all future versions and support by e-mail at this price! See
  84. registration details below.
  85. ----------------------------------------------------------------------------
  86.  
  87. INSTALLATION
  88.  
  89.   1. Requirements are
  90.         o OS/2 2.x or later;
  91.         o TCP/IP stack: IBM TCP/IP 2.0 for OS/2, OS/2 Warp Connect, OS/2
  92.           Warp Internet Access Kit;
  93.         o HPFS formatted drive to be able to download files which are not
  94.           8.3-compliant.
  95.         o In addition, you also have to install emx runtime package. If you
  96.           don't have it installed, file "emx.dll" is supplied with this
  97.           version of NFTP. Copy it into any directory listed in your
  98.           LIBPATH. If you want to obtain complete emx runtime package and/or
  99.           its source, you can get it from the following anonymous ftp
  100.           servers:
  101.           ftp.uni-stuttgart.de:/pub/systems/os2/emx-0.9b/
  102.           hobbes.nmsu.edu://os2/unix/emx09b/
  103.           ftp.cdrom.com:/pub/os2/lang/emx09b/
  104.           ftp.sai.msu.su:/pub/os2/programming/emx-0.9b/
  105.           EMX runtime support is contained in file emxrt.zip; instructions
  106.           on installing it can be found inside archive.
  107.   2. Installation.
  108.  
  109.      Unpack archive nftp*.zip into some directory and run install.cmd. After
  110.      answering some questions necessary files will be copied to the
  111.      directory you specified and your WPS desktop will hold two new objects
  112.      -- "NFTP" (executable) and "NFTP Manual". You probably already done
  113.      that because you're reading that "NFTP Manual"!
  114.  
  115.      If you want to install NFTP by hand (without install.cmd), copy all
  116.      files into the directory of your choice (eg, "d:\apps\tcpip\nftp"),
  117.      load nftp.ini into your favourite ASCII text editor (eg, TEDIT shipped
  118.      with Warp) and insert your e-mail address (it will be used as a
  119.      password for anonymous logins) at the appropriate place (line
  120.  
  121.                anonymous-password="your-e-mail-address"
  122.  
  123.  
  124.      ). I also suggest to decide where you will keep your bookmarks and
  125.      transfer history and set corresponding variables accordingly. If you
  126.      like to launch programs from desktop, create program object for NFTP.
  127.      Put supplied nftp.mrk file into the directory which you've chosen in
  128.      nftp.ini.
  129.  
  130.      The language NFTP uses is determined by environment variable NFTP_LANG.
  131.      It should be set to the name (without extension) of corresponding DLL
  132.      file. E.g., if you want to use Japanese version, you should use
  133.  
  134.                set NFTP_LANG=japanes
  135.  
  136.  
  137.      This statement can be put to config.sys or to the batch file invoking
  138.      nftp (install.cmd does exactly this). If you only need English version
  139.      you may omit this variable.
  140.  
  141.      install.cmd creates Workplace shell object to run NFTP. This feature
  142.      can be useful even you are die-hard command-line user (see below). NFTP
  143.      can run in a fullscreen session or in a VIO window. Installation script
  144.      sets it to run in a window, and window will not be closed automatically
  145.      after exit -- this can help to diagnose problems. Turn it off when
  146.      everything works as expected.
  147.  
  148. ----------------------------------------------------------------------------
  149.  
  150. QUICK START
  151.  
  152. After installation, run nftp.exe (from command line or WPS object). If
  153. you're launching NFTP from WPS object created by installation script you
  154. will be asked to enter "FTP server to log in"; simply press ENTER now. You
  155. should see list of bookmarks on the screen. Use cursor keys to select one of
  156. them and press ENTER. If everything is set up correctly, you'll see
  157. client-server negotiation and then finally list of files and directories on
  158. the ftp server you've chosen. Hit SPACE to view control connection window
  159. (and it is scrollable!), TAB to view local files/directories. Return to
  160. remote directory view by pressing space/tab another time. Move pointer with
  161. cursor keys, press ENTER on a directory to enter it. If you know name of the
  162. file (or first symbols of the name), type it directly: NFTP will try to
  163. position cursor on a file which name starts with these symbols. Select files
  164. to download with INSERT or simply press F5 to transfer single file. To
  165. upload file to server, switch to local files view (with TAB), select file(s)
  166. and press Shift-F5. To view local or remote file, move pointer to it and
  167. press F3 (of course, remote file will be downloaded first -- that will
  168. probably take some time). Navigating in the viewer is simple and intuitive:
  169. scroll file with cursor keys. Press F10 to log off and exit NFTP.
  170. ----------------------------------------------------------------------------
  171.  
  172. USAGE: LAUNCHING NFTP
  173.  
  174. You often already know where the file you need right now is located. Let's
  175. suppose, say, you want to retrieve RFC 959 from
  176.  
  177.        src.doc.ic.ac.uk:/pub/rfc/
  178.  
  179.  
  180. Launch nftp in the following fashion:
  181.  
  182.        nftp  src.doc.ic.ac.uk:/pub/rfc
  183.  
  184.  
  185. or
  186.  
  187.        nftp  src.doc.ic.ac.uk/pub/rfc
  188.  
  189.  
  190. After logging in into src.doc.ic.ac.uk nftp will change directory for you to
  191. /pub/rfc. Having